{ "info": { "_postman_id": "8c245421-c09f-474d-8bb2-e6c9aa63c610", "name": "API Docs", "description": "### Servers and Resources\n\n- Licensing Platform (LP) [https://music.clicknclear.com](https://music.clicknclear.com)\n \n- License Verification System (LVS) [https://verification.clicknclear.com](https://verification.clicknclear.com)\n \n- Support Email [support@clicknclear.com](https://mailto:support@clicknclear.com)\n \n- Tech Team Email [techteam@clicknclear.com](https://mailto:techteam@clicknclear.com)\n \n\n### API Keys\n\nTo create an API key please make sure you first contact a ClicknClear admin so they can enable API Key support for your user account.\n\n### API Key Setup\n\n- Navigate to [https://music.clicknclear.com/profile](https://music.clicknclear.com/profile) (login if you are not).\n \n- If your account is setup correctly you should have an \"API Keys\" section. If you cannot see this section please get in contact via the support email or the Tech Team email.\n \n- Click the \"Create API Key\" button.\n \n- Enter a name for the API Key, this is to help you identify it at a later date.\n \n- Copy the API Key ID and the API Key Secret and store them somewhere safe, you will not be able to view the Key Secret again.\n \n- To use the postman collection, copy the API Key ID and the API Key Secret into the relevant postman environment variables.\n \n\n### Authentication\n\nSee the Login routes for more information on how to get Access Tokens and Refresh Tokens. \nThere is a Postman script on the Login route that will automatically add the access and refresh tokens to your postman environment. \nTo authenticate your requests to the ClicknClear API add the access token to the \"Authorization\" header with the value of \"Bearer {ACCESS_TOKEN}\".\n\nExample:\n\n```\n'Authorization': 'Bearer XXXXX'\n\n ```\n\n### Server Responses\n\n#### Return Types\n\nMost endpoints will have example responses, however they may not always be 100% up to date. To find up to date, annotated typescript types you can directly use or view on Github, please see: [https://github.com/ClicknClear/Public-Resources/tree/main/packages/lvs-types](https://github.com/ClicknClear/Public-Resources/tree/main/packages/lvs-types)\n\n#### Return Codes\n\nThroughout our APIs we heavily utilise [HTTP Codes](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status) to signify the status of the request. In general, a 4xx status code will have the error type and usually a message to help the developer know why the request failed. Below is an example of an erroneous login request.\n\n```\n{\n \"statusCode\": 400,\n \"error\": \"Bad Request\",\n \"message\": \"[\\n {\\n \\\"code\\\": \\\"invalid_type\\\",\\n \\\"expected\\\": \\\"string\\\",\\n \\\"received\\\": \\\"undefined\\\",\\n \\\"path\\\": [\\n \\\"apiKey\\\"\\n ],\\n \\\"message\\\": \\\"Required\\\"\\n }\\n]\"\n}\n\n ```\n\nIf you are consistently receiving 400s or even 500s and you're not sure how to fix it please email the Tech Team email with steps to reproduce your issue.", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "_exporter_id": "7983255" }, "item": [ { "name": "Auth", "item": [ { "name": "Login", "event": [ { "listen": "test", "script": { "exec": [ "const jsonData = JSON.parse(responseBody);", "if (pm.response.status === 'OK') {", " const {", " accessToken,", " refreshToken,", " } = jsonData;", " pm.environment.set(\"accessToken\", accessToken);", " pm.environment.set(\"refreshToken\", refreshToken);", "} else {", " throw new Error(`Login failed: ${pm.response.status}`)", "}" ], "type": "text/javascript", "packages": {}, "requests": {} } } ], "request": { "auth": { "type": "noauth" }, "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\"key\": \"{{keyID}}\", \"secret\": \"{{keySecret}}\"}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{lpURL}}/api/auth/api-key/login", "host": [ "{{lpURL}}" ], "path": [ "api", "auth", "api-key", "login" ], "query": [ { "key": "", "value": null, "disabled": true } ] }, "description": "This endpoint should be used to get an access token and a refresh token from a key & secret. Once the access token is fetched it should be used to authenticate to other API endpoints." }, "response": [ { "name": "Login", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\"key\": \"{{keyID}}\", \"secret\": \"{{keySecret}}\"}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{lpURL}}/api/auth/api-key/login", "host": [ "{{lpURL}}" ], "path": [ "api", "auth", "api-key", "login" ], "query": [ { "key": "", "value": null, "disabled": true } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Wed, 28 Jan 2026 14:43:37 GMT" }, { "key": "Content-Type", "value": "application/json", "description": "", "type": "text" }, { "key": "Content-Length", "value": "376" }, { "key": "Connection", "value": "keep-alive" }, { "key": "Set-Cookie", "value": "AWSALB=zLMJD26QTK1qOpJG1CbNYcNfY3vSPAUOMfiOZV+otx/evoKSCeJYi9qWCwsSqsudeZuSxlsFvKZwwuJ0GLgoxcn8JYGCRJBt/Zc7LeT9GIubvCdk8NjxGcEcpla9; Expires=Wed, 04 Feb 2026 14:43:37 GMT; Path=/" }, { "key": "Set-Cookie", "value": "AWSALBCORS=zLMJD26QTK1qOpJG1CbNYcNfY3vSPAUOMfiOZV+otx/evoKSCeJYi9qWCwsSqsudeZuSxlsFvKZwwuJ0GLgoxcn8JYGCRJBt/Zc7LeT9GIubvCdk8NjxGcEcpla9; Expires=Wed, 04 Feb 2026 14:43:37 GMT; Path=/; SameSite=None; Secure" }, { "key": "vary", "value": "Origin" }, { "key": "access-control-allow-credentials", "value": "true" }, { "key": "x-ratelimit-limit", "value": "25" }, { "key": "x-ratelimit-remaining", "value": "24" }, { "key": "x-ratelimit-reset", "value": "60" }, { "key": "tdm-reservation", "value": "1" }, { "key": "x-robots-tag", "value": "noai, noimageai" } ], "cookie": [ { "expires": "Invalid Date", "domain": "", "path": "" } ], "body": "{\n \"accessTokenExpiresIn\": 86400,\n \"refreshTokenExpiresIn\": 604800,\n \"accessToken\": \"XX\",\n \"refreshToken\": \"XX\"\n}" } ] }, { "name": "Refresh", "request": { "auth": { "type": "noauth" }, "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\n \"refreshToken\": \"{{refreshToken}}\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{lpURL}}/api/auth/access-token/refresh", "host": [ "{{lpURL}}" ], "path": [ "api", "auth", "access-token", "refresh" ] }, "description": "This endpoint can be used to get a new access token from a refresh token without having to call the login API endpoint again." }, "response": [ { "name": "Refresh", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\n \"refreshToken\": \"{{refreshToken}}\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{lpURL}}/api/auth/access-token/refresh", "host": [ "{{lpURL}}" ], "path": [ "api", "auth", "access-token", "refresh" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Wed, 28 Jan 2026 13:46:55 GMT" }, { "key": "Content-Type", "value": "application/json", "description": "", "type": "text" }, { "key": "Content-Length", "value": "187" }, { "key": "Connection", "value": "keep-alive" }, { "key": "Set-Cookie", "value": "AWSALB=4Wb/IMbEtPo+Lh8GdQrJy1+ZNHky/XrQkGwkZ/W8W8yFNtUz3TILpqo44894FCDGs7GVAqnHqIgywoiTYOSc0k77Ov92OLtWncS85wlLDlLJ9ABrFU6aDb3CMIDu; Expires=Wed, 04 Feb 2026 13:46:55 GMT; Path=/" }, { "key": "Set-Cookie", "value": "AWSALBCORS=4Wb/IMbEtPo+Lh8GdQrJy1+ZNHky/XrQkGwkZ/W8W8yFNtUz3TILpqo44894FCDGs7GVAqnHqIgywoiTYOSc0k77Ov92OLtWncS85wlLDlLJ9ABrFU6aDb3CMIDu; Expires=Wed, 04 Feb 2026 13:46:55 GMT; Path=/; SameSite=None; Secure" }, { "key": "vary", "value": "Origin" }, { "key": "access-control-allow-credentials", "value": "true" }, { "key": "x-ratelimit-limit", "value": "1000" }, { "key": "x-ratelimit-remaining", "value": "999" }, { "key": "x-ratelimit-reset", "value": "60" }, { "key": "tdm-reservation", "value": "1" }, { "key": "x-robots-tag", "value": "noai, noimageai" } ], "cookie": [ { "expires": "Invalid Date", "domain": "", "path": "" } ], "body": "{\n \"accessToken\": \"accessToken\",\n \"accessTokenExpiresIn\": 86400\n}" } ] } ], "description": "A collection of requests that involve authentication" }, { "name": "Organisations", "item": [ { "name": "Get My Organisations", "request": { "method": "GET", "header": [], "url": { "raw": "{{lpURL}}/api/orgs/me", "host": [ "{{lpURL}}" ], "path": [ "api", "orgs", "me" ] }, "description": "This endpoint can be used to get all organisations that this user account has access to." }, "response": [ { "name": "Get My Organisations", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{lpURL}}/api/orgs/me", "host": [ "{{lpURL}}" ], "path": [ "api", "orgs", "me" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Fri, 12 Jul 2024 13:02:19 GMT" }, { "key": "Content-Type", "value": "application/json; charset=utf-8" }, { "key": "Transfer-Encoding", "value": "chunked" }, { "key": "Connection", "value": "keep-alive" }, { "key": "Server", "value": "nginx" }, { "key": "vary", "value": "Origin" }, { "key": "x-ratelimit-limit", "value": "1000" }, { "key": "x-ratelimit-remaining", "value": "999" }, { "key": "x-ratelimit-reset", "value": "60" }, { "key": "tdm-reservation", "value": "1" }, { "key": "x-robots-tag", "value": "noai, noimageai" }, { "key": "X-Frame-Options", "value": "DENY" }, { "key": "X-Content-Type-Options", "value": "nosniff" }, { "key": "Strict-Transport-Security", "value": ": max-age=63072000; includeSubDomains; preload" }, { "key": "Content-Encoding", "value": "gzip" } ], "cookie": [], "body": "[\n {\n \"id\": 1,\n \"name\": \"ClicknClear\",\n \"logo\": {\n \"id\": 7,\n \"fileType\": \"Image\",\n \"fileName\": \"black logo+.jpg\",\n \"signedUrl\": \"https://example.clicknclear.com\"\n },\n \"createdAt\": \"2022-01-14T16:06:50.234Z\",\n \"deletedAt\": null,\n \"parentId\": null,\n \"updatedAt\": \"2023-03-01T13:02:59.000Z\",\n \"isEventProducer\": true\n },\n {\n \"id\": 8,\n \"name\": \"ClicknClear School\",\n \"createdAt\": \"2022-10-04T16:38:39.642Z\",\n \"deletedAt\": null,\n \"parentId\": 1,\n \"updatedAt\": \"2022-10-04T16:38:39.642Z\",\n \"isEventProducer\": true\n },\n {\n \"id\": 13,\n \"name\": \"Compete\",\n \"createdAt\": \"2023-02-16T09:48:14.492Z\",\n \"deletedAt\": null,\n \"parentId\": 8,\n \"updatedAt\": \"2023-02-16T09:48:14.492Z\",\n \"isEventProducer\": true\n },\n {\n \"id\": 14,\n \"name\": \"Your Organization\",\n \"createdAt\": \"2023-03-02T19:43:59.535Z\",\n \"deletedAt\": null,\n \"parentId\": 1,\n \"updatedAt\": \"2023-03-02T19:43:59.535Z\",\n \"isEventProducer\": true\n },\n {\n \"id\": 15,\n \"name\": \"Example Organization\",\n \"logo\": {\n \"id\": 26,\n \"fileType\": \"Image\",\n \"fileName\": \"YOUR PARENT ORGANIZATION LOGO.png\",\n \"signedUrl\": \"https://example.clicknclear.com\"\n },\n \"createdAt\": \"2024-02-22T20:47:20.025Z\",\n \"deletedAt\": null,\n \"parentId\": 1,\n \"updatedAt\": \"2024-02-27T14:39:52.000Z\",\n \"isEventProducer\": true\n },\n {\n \"id\": 16,\n \"name\": \"HERmesa\",\n \"logo\": {\n \"id\": 27,\n \"fileType\": \"Image\",\n \"fileName\": \"Screenshot 2024-02-27 at 15.53.47.png\",\n \"signedUrl\": \"https://example.clicknclear.com\"\n },\n \"createdAt\": \"2024-02-27T20:53:53.002Z\",\n \"deletedAt\": null,\n \"parentId\": 1,\n \"updatedAt\": \"2024-02-27T20:53:53.002Z\",\n \"isEventProducer\": true\n },\n {\n \"id\": 17,\n \"name\": \"Example Organization\",\n \"logo\": {\n \"id\": 32,\n \"fileType\": \"Image\",\n \"fileName\": \"LVS Guide graphics.png\",\n \"signedUrl\": \"https://example.clicknclear.com\"\n },\n \"createdAt\": \"2024-02-28T13:38:33.671Z\",\n \"deletedAt\": null,\n \"parentId\": 15,\n \"updatedAt\": \"2024-03-01T19:04:10.000Z\",\n \"isEventProducer\": true\n },\n {\n \"id\": 18,\n \"name\": \"Your Child Org 1\",\n \"logo\": {\n \"id\": 31,\n \"fileType\": \"Image\",\n \"fileName\": \"CHILD ORG LOGO.png\",\n \"signedUrl\": \"https://example.clicknclear.com\"\n },\n \"createdAt\": \"2024-02-28T20:02:03.127Z\",\n \"deletedAt\": null,\n \"parentId\": 17,\n \"updatedAt\": \"2024-02-28T20:02:03.127Z\",\n \"isEventProducer\": true\n }\n]" } ] } ] }, { "name": "Seasons V1", "item": [ { "name": "Get Seasons", "request": { "method": "GET", "header": [], "url": { "raw": "{{lvsURL}}/api/public/v1/season", "host": [ "{{lvsURL}}" ], "path": [ "api", "public", "v1", "season" ] }, "description": "The get seasons endpoint returns all seasons that the current user account has access to. This includes any seasons of child organisations. \nTo view the annotated Typescript response please go to: [https://github.com/ClicknClear/Public-Resources/blob/main/packages/lvs-types/src/v1/season.ts](https://github.com/ClicknClear/Public-Resources/blob/d8a84505e9ee08c826839bac462a36a79e5cf0f9/packages/lvs-types/src/v1/season.ts)" }, "response": [ { "name": "Get Seasons", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{lvsURL}}/api/public/v1/season", "host": [ "{{lvsURL}}" ], "path": [ "api", "public", "v1", "season" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Fri, 12 Jul 2024 13:04:46 GMT" }, { "key": "Content-Type", "value": "application/json; charset=utf-8" }, { "key": "Content-Length", "value": "4996" }, { "key": "Connection", "value": "keep-alive" } ], "cookie": [], "body": "[\n {\n \"id\": 14,\n \"isLocked\": false,\n \"territories\": [],\n \"organisationId\": 1,\n \"title\": \"Everything Enabled Season\",\n \"endDate\": \"2024-06-27T00:00:00.000Z\",\n \"startDate\": \"2024-06-20T00:00:00.000Z\",\n \"inviteURL\": \"https://example.clicknclear.com\",\n \"signupFields\": []\n },\n {\n \"id\": 11,\n \"isLocked\": false,\n \"territories\": [],\n \"organisationId\": 17,\n \"title\": \"Your Season Title\",\n \"endDate\": \"2025-02-20T00:00:00.000Z\",\n \"startDate\": \"2024-03-10T00:00:00.000Z\",\n \"signupFields\": [\n {\n \"id\": 50,\n \"isRequired\": true,\n \"options\": [],\n \"order\": 0,\n \"question\": \"Please enter your participant ID\",\n \"description\": \"\",\n \"type\": \"shortAnswer\",\n \"key\": null\n }\n ]\n },\n {\n \"id\": 10,\n \"isLocked\": false,\n \"territories\": [],\n \"organisationId\": 15,\n \"title\": \"Example Season\",\n \"endDate\": \"2025-01-31T00:00:00.000Z\",\n \"startDate\": \"2024-02-22T00:00:00.000Z\",\n \"inviteURL\": \"https://example.clicknclear.com\",\n \"signupFields\": [\n {\n \"id\": 69,\n \"isRequired\": true,\n \"options\": [],\n \"order\": 0,\n \"question\": \"What's your favourite colour?\",\n \"description\": \"\",\n \"type\": \"shortAnswer\",\n \"key\": null\n }\n ]\n },\n {\n \"id\": 7,\n \"isLocked\": false,\n \"territories\": [],\n \"organisationId\": 1,\n \"title\": \"testing edits\",\n \"endDate\": \"2024-02-28T00:00:00.000Z\",\n \"startDate\": \"2024-01-31T00:00:00.000Z\",\n \"inviteURL\": \"https://example.clicknclear.com\",\n \"signupFields\": [\n {\n \"id\": 40,\n \"isRequired\": true,\n \"options\": [],\n \"order\": 0,\n \"question\": \"s1\",\n \"description\": \"\",\n \"type\": \"shortAnswer\",\n \"key\": null\n },\n {\n \"id\": 41,\n \"isRequired\": true,\n \"options\": [],\n \"order\": 1,\n \"question\": \"s2\",\n \"description\": \"\",\n \"type\": \"shortAnswer\",\n \"key\": null\n }\n ]\n },\n {\n \"id\": 6,\n \"isLocked\": false,\n \"territories\": [],\n \"organisationId\": 1,\n \"title\": \"Work Season\",\n \"endDate\": \"2024-01-25T00:00:00.000Z\",\n \"startDate\": \"2024-01-18T00:00:00.000Z\",\n \"inviteURL\": \"https://example.clicknclear.com\",\n \"signupFields\": []\n },\n {\n \"id\": 5,\n \"isLocked\": false,\n \"territories\": [],\n \"organisationId\": 1,\n \"title\": \"New Season\",\n \"endDate\": \"2024-01-15T00:00:00.000Z\",\n \"startDate\": \"2024-01-08T00:00:00.000Z\",\n \"inviteURL\": \"https://example.clicknclear.com\",\n \"signupFields\": []\n },\n {\n \"id\": 3,\n \"isLocked\": false,\n \"territories\": [],\n \"organisationId\": 1,\n \"title\": \"SR Season 2023 / 2025\",\n \"endDate\": \"2024-02-29T00:00:00.000Z\",\n \"startDate\": \"2023-03-01T00:00:00.000Z\",\n \"inviteURL\": \"https://example.clicknclear.com\",\n \"signupFields\": [\n {\n \"id\": 34,\n \"isRequired\": true,\n \"options\": [],\n \"order\": 0,\n \"question\": \"edited q\",\n \"description\": \"\",\n \"type\": \"shortAnswer\",\n \"key\": null\n },\n {\n \"id\": 35,\n \"isRequired\": true,\n \"options\": [],\n \"order\": 1,\n \"question\": \"fewfewfwe\",\n \"description\": \"\",\n \"type\": \"shortAnswer\",\n \"key\": null\n }\n ]\n },\n {\n \"id\": 1,\n \"isLocked\": false,\n \"territories\": [],\n \"organisationId\": 1,\n \"title\": \"KANSAS 2023/2024\",\n \"endDate\": \"2023-10-31T00:00:00.000Z\",\n \"startDate\": \"2023-01-01T00:00:00.000Z\",\n \"inviteURL\": \"https://example.clicknclear.com\",\n \"signupFields\": []\n }\n]" } ] }, { "name": "Get Entries", "request": { "method": "POST", "header": [], "body": { "mode": "raw", "raw": "", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{lvsURL}}/api/public/v1/season/:seasonId/entries", "host": [ "{{lvsURL}}" ], "path": [ "api", "public", "v1", "season", ":seasonId", "entries" ], "query": [ { "key": "", "value": null, "disabled": true } ], "variable": [ { "key": "seasonId", "value": "" } ] }, "description": "The Get Entries API endpoint can be used to get season entries along with any license data.\n\nThe shape of the result body can be found starting in: [https://github.com/ClicknClear/Public-Resources/blob/main/packages/lvs-types/src/v1/entry.ts](https://github.com/ClicknClear/Public-Resources/blob/main/packages/lvs-types/src/v1/entry.ts) \nwith the IEntryV1 type. Due to the complex return type the exact types are spread amongst a few different files.\n\nThis endpoint has an optional request body which can be used to filter down the results. If no body is supplied it will return all results. By supplying the body, you can filter based on the updatedAfter or by the signup field responses. The zod schemas can be found in this file: [https://github.com/ClicknClear/Public-Resources/blob/main/packages/lvs-types/src/v1/entry.ts](https://github.com/ClicknClear/Public-Resources/blob/main/packages/lvs-types/src/v1/entry.ts) and it is called getEntriesQuerySchemaV1.\n\nExample requests can be found filtering by both updatedAfter and signup fields." }, "response": [ { "name": "All Entries", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "raw", "raw": "", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{lvsURL}}/api/public/v1/season/:seasonId/entries", "host": [ "{{lvsURL}}" ], "path": [ "api", "public", "v1", "season", ":seasonId", "entries" ], "query": [ { "key": "", "value": null, "disabled": true } ], "variable": [ { "key": "seasonId", "value": "37" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Access-Control-Allow-Origin", "value": "*" }, { "key": "content-type", "value": "application/json; charset=utf-8" }, { "key": "content-length", "value": "8936" }, { "key": "date", "value": "Fri, 12 Jul 2024 10:11:28 GMT" }, { "key": "connection", "value": "close" } ], "cookie": [], "body": "[\n {\n \"id\": 27,\n \"email\": \"tristan+test@clicknclear.com\",\n \"name\": \"My Test User\",\n \"fields\": [\n {\n \"value\": \"123456789\",\n \"signupFieldId\": 89,\n \"key\": \"externalId\"\n }\n ],\n \"soundRecording\": {\n \"createdAt\": \"2024-07-11T15:21:26.706Z\",\n \"downloadURL\": \"https://example.clicknclear.com\",\n \"uploadFileName\": \"Eric Clapton - Lay Down Sally (Live).mp3\",\n \"licenseStatus\": \"Unverified\",\n \"songsConfirmedAt\": \"2024-07-11T16:22:56.000Z\",\n \"updatedAt\": \"2024-07-11T15:22:56.000Z\",\n \"status\": \"Complete\",\n \"songs\": [\n {\n \"title\": \"Lay Down Sally (Live)\",\n \"artists\": \"Eric Clapton\",\n \"endTime\": 310,\n \"startTime\": 0,\n \"cncMixId\": null,\n \"cncId\": \"5fb5a20bc52b507e3f154ae1\",\n \"composer\": null,\n \"isrc\": \"NLRD51424699\",\n \"iswc\": null,\n \"publisher\": null,\n \"recordLabel\": \"Black Barn Music\",\n \"tunecode\": null,\n \"yearOfRelease\": 2020,\n \"upc\": null,\n \"manualStatus\": null,\n \"licenseStatus\": \"Unverified\",\n \"licenseChecks\": {\n \"Licensee Name Match\": \"Unknown\",\n \"License Source Matches\": \"Unknown\",\n \"Title Matches\": \"Unknown\",\n \"Artists Match\": \"Unknown\",\n \"Master Choreography Rights\": \"Unknown\",\n \"Master Adaptation Rights\": \"Unknown\",\n \"Master Duplication Rights\": \"Unknown\",\n \"Publishing Choreography Rights\": \"Unknown\",\n \"Publishing Adaptation Rights\": \"Unknown\",\n \"Publishing Duplication Rights\": \"Unknown\",\n \"Valid Date\": \"Unknown\",\n \"Full Ownership\": \"Unknown\",\n \"Territory Match\": {\n \"GB\": \"Unknown\",\n \"AF\": \"Unknown\",\n \"US\": \"Unknown\"\n }\n },\n \"licenseData\": {\n \"bespokeAgreement\": null,\n \"licenseSource\": \"Pending License\",\n \"cncLicense\": null,\n \"externalLicense\": null,\n \"publicDomainProof\": null\n }\n }\n ]\n }\n },\n {\n \"id\": 28,\n \"email\": \"tristan+test@clicknclear.com\",\n \"name\": \"No Signup User\",\n \"fields\": [\n {\n \"value\": \"123456789\",\n \"signupFieldId\": 89,\n \"key\": \"externalId\"\n }\n ],\n \"soundRecording\": null\n },\n {\n \"id\": 26,\n \"email\": \"tristan+test@clicknclear.com\",\n \"name\": \"Partial Territories\",\n \"fields\": [],\n \"soundRecording\": {\n \"createdAt\": \"2024-07-08T07:20:14.938Z\",\n \"downloadURL\": \"https://example.clicknclear.com\",\n \"uploadFileName\": \"MY_MIX_WITH_MATCHES.mp3\",\n \"licenseStatus\": \"Licensed\",\n \"songsConfirmedAt\": \"2024-07-08T08:25:18.000Z\",\n \"updatedAt\": \"2024-07-08T07:25:18.000Z\",\n \"status\": \"Complete\",\n \"songs\": [\n {\n \"title\": \"She's My Addiction\",\n \"artists\": \"Fozzy\",\n \"endTime\": 136,\n \"startTime\": 0,\n \"cncMixId\": null,\n \"cncId\": \"5f4d360c6fce45507b4b3870\",\n \"composer\": null,\n \"isrc\": null,\n \"iswc\": null,\n \"publisher\": null,\n \"recordLabel\": \"Century Media\",\n \"tunecode\": null,\n \"yearOfRelease\": 2012,\n \"upc\": null,\n \"manualStatus\": null,\n \"licenseStatus\": \"Licensed\",\n \"licenseChecks\": {\n \"Licensee Name Match\": \"Accepted\",\n \"License Source Matches\": \"Accepted\",\n \"Title Matches\": \"Accepted\",\n \"Artists Match\": \"Accepted\",\n \"Master Choreography Rights\": \"Accepted\",\n \"Master Adaptation Rights\": \"Accepted\",\n \"Master Duplication Rights\": \"Accepted\",\n \"Publishing Choreography Rights\": \"Accepted\",\n \"Publishing Adaptation Rights\": \"Accepted\",\n \"Publishing Duplication Rights\": \"Accepted\",\n \"Valid Date\": \"Accepted\",\n \"Full Ownership\": \"Accepted\",\n \"Territory Match\": {\n \"GB\": \"Rejected\",\n \"AF\": \"Accepted\",\n \"US\": \"Rejected\"\n }\n },\n \"licenseData\": {\n \"bespokeAgreement\": null,\n \"licenseSource\": \"ClicknClear\",\n \"cncLicense\": {\n \"ref\": \"cff52747f638da48490f7b8b6e370620\",\n \"datePurchased\": \"2024-07-08T08:19:41.000Z\",\n \"validTo\": \"2025-07-08T08:19:41.000Z\",\n \"downloadURL\": \"https://example.clicknclear.com\",\n \"rights\": [\n {\n \"name\": \"Standard\",\n \"variant\": \"1 Year\"\n }\n ],\n \"territories\": [\n \"AF\"\n ]\n },\n \"externalLicense\": null,\n \"publicDomainProof\": null\n }\n },\n {\n \"title\": \"All Black\",\n \"artists\": \"Good Charlotte\",\n \"endTime\": 10,\n \"startTime\": 0,\n \"cncMixId\": null,\n \"cncId\": \"5f416a3771aa9d16b0886b07\",\n \"composer\": null,\n \"isrc\": \"USSM10607451\",\n \"iswc\": null,\n \"publisher\": null,\n \"recordLabel\": \"Epic/Daylight\",\n \"tunecode\": null,\n \"yearOfRelease\": 2007,\n \"upc\": null,\n \"manualStatus\": null,\n \"licenseStatus\": \"Licensed\",\n \"licenseChecks\": {\n \"Licensee Name Match\": \"Accepted\",\n \"License Source Matches\": \"Accepted\",\n \"Title Matches\": \"Accepted\",\n \"Artists Match\": \"Accepted\",\n \"Master Choreography Rights\": \"Accepted\",\n \"Master Adaptation Rights\": \"Accepted\",\n \"Master Duplication Rights\": \"Accepted\",\n \"Publishing Choreography Rights\": \"Accepted\",\n \"Publishing Adaptation Rights\": \"Accepted\",\n \"Publishing Duplication Rights\": \"Accepted\",\n \"Valid Date\": \"Accepted\",\n \"Full Ownership\": \"Accepted\",\n \"Territory Match\": {\n \"GB\": \"Rejected\",\n \"AF\": \"Accepted\",\n \"US\": \"Rejected\"\n }\n },\n \"licenseData\": {\n \"bespokeAgreement\": null,\n \"licenseSource\": \"ClicknClear\",\n \"cncLicense\": {\n \"ref\": \"cff52747f638da48490f7b8b6e370620\",\n \"datePurchased\": \"2024-07-08T08:19:41.000Z\",\n \"validTo\": \"2025-07-08T08:19:41.000Z\",\n \"downloadURL\": \"https://example.clicknclear.com\",\n \"rights\": [\n {\n \"name\": \"Standard\",\n \"variant\": \"1 Year\"\n }\n ],\n \"territories\": [\n \"AF\"\n ]\n },\n \"externalLicense\": null,\n \"publicDomainProof\": null\n }\n }\n ]\n }\n },\n {\n \"id\": 25,\n \"email\": \"tristan+test@clicknclear.com\",\n \"name\": \"Tristan\",\n \"fields\": [],\n \"soundRecording\": {\n \"createdAt\": \"2024-07-05T09:18:42.566Z\",\n \"downloadURL\": \"https://example.clicknclear.com\",\n \"uploadFileName\": \"John Williams - Main Theme (From _Jurassic Park_).mp3\",\n \"licenseStatus\": \"Licensed\",\n \"songsConfirmedAt\": \"2024-07-05T10:22:00.000Z\",\n \"updatedAt\": \"2024-07-05T09:22:00.000Z\",\n \"status\": \"Complete\",\n \"songs\": [\n {\n \"title\": \"Main Theme (From \\\"Jurassic Park\\\")\",\n \"artists\": \"John Williams\",\n \"endTime\": 330,\n \"startTime\": 0,\n \"cncMixId\": null,\n \"cncId\": \"5f3d053b47113550ed1a80e9\",\n \"composer\": null,\n \"isrc\": \"USSM19504354\",\n \"iswc\": null,\n \"publisher\": null,\n \"recordLabel\": null,\n \"tunecode\": null,\n \"yearOfRelease\": null,\n \"upc\": \"0886447845035\",\n \"manualStatus\": null,\n \"licenseStatus\": \"Licensed\",\n \"licenseChecks\": {\n \"Licensee Name Match\": \"Accepted\",\n \"License Source Matches\": \"Accepted\",\n \"Title Matches\": \"Accepted\",\n \"Artists Match\": \"Accepted\",\n \"Master Choreography Rights\": \"Accepted\",\n \"Master Adaptation Rights\": \"Accepted\",\n \"Master Duplication Rights\": \"Accepted\",\n \"Publishing Choreography Rights\": \"Accepted\",\n \"Publishing Adaptation Rights\": \"Accepted\",\n \"Publishing Duplication Rights\": \"Accepted\",\n \"Valid Date\": \"Accepted\",\n \"Full Ownership\": \"Accepted\",\n \"Territory Match\": {\n \"GB\": \"Accepted\",\n \"AF\": \"Accepted\",\n \"US\": \"Accepted\"\n }\n },\n \"licenseData\": {\n \"bespokeAgreement\": null,\n \"licenseSource\": \"ClicknClear\",\n \"cncLicense\": {\n \"ref\": \"42ae53188f3112058776f1b58610b9ac\",\n \"datePurchased\": \"2024-07-05T12:40:57.000Z\",\n \"validTo\": \"2025-07-05T10:18:10.000Z\",\n \"downloadURL\": \"https://example.clicknclear.com\",\n \"rights\": [\n {\n \"name\": \"Standard\",\n \"variant\": \"1 Year\"\n }\n ],\n \"territories\": [\n \"AD\",\n \"AE\",\n \"AF\",\n \"AG\",\n \"AL\",\n \"AM\",\n \"AO\",\n \"AR\",\n \"AT\",\n \"AU\",\n \"AZ\",\n \"BA\",\n \"BB\",\n \"BD\",\n \"BE\",\n \"BF\",\n \"BG\",\n \"BH\",\n \"BI\",\n \"BJ\",\n \"BN\",\n \"BO\",\n \"BR\",\n \"BS\",\n \"BT\",\n \"BW\",\n \"BY\",\n \"BZ\",\n \"CA\",\n \"CF\",\n \"CG\",\n \"CI\",\n \"CL\",\n \"CM\",\n \"CN\",\n \"CO\",\n \"CR\",\n \"CU\",\n \"CV\",\n \"CY\",\n \"CZ\",\n \"DJ\",\n \"DK\",\n \"DM\",\n \"DO\",\n \"DZ\",\n \"EC\",\n \"EE\",\n \"EG\",\n \"EH\",\n \"ER\",\n \"ES\",\n \"ET\",\n \"FI\",\n \"FJ\",\n \"FR\",\n \"GA\",\n \"GB\",\n \"GD\",\n \"GE\",\n \"GM\",\n \"GN\",\n \"GQ\",\n \"GR\",\n \"GT\",\n \"GW\",\n \"GY\",\n \"HK\",\n \"HN\",\n \"HR\",\n \"HT\",\n \"HU\",\n \"ID\",\n \"IE\",\n \"IL\",\n \"IN\",\n \"IQ\",\n \"IR\",\n \"IS\",\n \"IT\",\n \"JM\",\n \"JO\",\n \"KE\",\n \"KG\",\n \"KH\",\n \"KM\",\n \"KN\",\n \"KR\",\n \"KW\",\n \"KZ\",\n \"LA\",\n \"LB\",\n \"LC\",\n \"LK\",\n \"LR\",\n \"LS\",\n \"LT\",\n \"LU\",\n \"LV\",\n \"LY\",\n \"MA\",\n \"MC\",\n \"MD\",\n \"ME\",\n \"MG\",\n \"MK\",\n \"ML\",\n \"MN\",\n \"MR\",\n \"MT\",\n \"MU\",\n \"MV\",\n \"MW\",\n \"MX\",\n \"MY\",\n \"MZ\",\n \"NA\",\n \"NC\",\n \"NE\",\n \"NG\",\n \"NI\",\n \"NL\",\n \"NO\",\n \"NP\",\n \"NR\",\n \"NZ\",\n \"OM\",\n \"PA\",\n \"PE\",\n \"PF\",\n \"PG\",\n \"PH\",\n \"PK\",\n \"PL\",\n \"PR\",\n \"PT\",\n \"PY\",\n \"QA\",\n \"RO\",\n \"RS\",\n \"RU\",\n \"RW\",\n \"SA\",\n \"SB\",\n \"SC\",\n \"SE\",\n \"SG\",\n \"SI\",\n \"SK\",\n \"SL\",\n \"SM\",\n \"SN\",\n \"SO\",\n \"SR\",\n \"SS\",\n \"ST\",\n \"SV\",\n \"SY\",\n \"SZ\",\n \"TD\",\n \"TG\",\n \"TH\",\n \"TJ\",\n \"TM\",\n \"TN\",\n \"TR\",\n \"TT\",\n \"TW\",\n \"TZ\",\n \"UA\",\n \"UG\",\n \"US\",\n \"UY\",\n \"UZ\",\n \"VA\",\n \"VC\",\n \"VE\",\n \"VN\",\n \"VU\",\n \"WS\",\n \"YE\",\n \"ZA\",\n \"ZM\",\n \"ZW\"\n ]\n },\n \"externalLicense\": null,\n \"publicDomainProof\": null\n }\n }\n ]\n }\n }\n]" }, { "name": "Filter By Signup Field", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"fields\": [\n {\n \"key\": \"externalId\",\n \"value\": \"123456789\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{lvsURL}}/api/public/v1/season/:seasonId/entries", "host": [ "{{lvsURL}}" ], "path": [ "api", "public", "v1", "season", ":seasonId", "entries" ], "query": [ { "key": "", "value": null, "disabled": true } ], "variable": [ { "key": "seasonId", "value": "14" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json", "description": "", "type": "text" } ], "cookie": [], "body": "" }, { "name": "Filter By Updated After", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"updatedAfter\": \"2024-07-11T15:20:00.000Z\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{lvsURL}}/api/public/v1/season/:seasonId/entries", "host": [ "{{lvsURL}}" ], "path": [ "api", "public", "v1", "season", ":seasonId", "entries" ], "query": [ { "key": "", "value": null, "disabled": true } ], "variable": [ { "key": "seasonId", "value": "14" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "Text", "header": [], "cookie": [], "body": "" } ] } ], "description": "This folder contains all requests for the LVS Seasons and related entities.\n\nSeasons can be viewed and edited through: [https://verification.clicknclear.com/en-gb/my-seasons.](https://verification.clicknclear.com/en-gb/my-seasons.) \nWhen testing feel free to create a sandbox or test season. \nIf you wanted to test the season signup and responses you can do so by going through the season signup URL. We recommend signing up to the season with a different user account to the one which can create seasons. This will ensure that the what you see will reflect what the Team/Athletes see\n\nEG: Producer Account: [tristan@clicknclear.com](https://mailto:tristan@clicknclear.com) Signup Account: [tristan+test@clicknclear.com](https://mailto:tristan+test@clicknclear.com)" }, { "name": "Verification Job V1", "item": [ { "name": "Create Verification Job", "request": { "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\n \"name\": \"Tristan Barlow\",\n \"email\": \"tristan@clicknclear.com\",\n \"requiredTerritories\": [\n \"US\",\n \"GB\"\n ],\n \"startDate\": \"2024-09-01\",\n \"endDate\": \"2024-09-04\",\n \"externalId\": \"1234567890\",\n \"organisationId\": 1,\n \"audioFileURL\": \"https://clicknclear-public-resources.s3.eu-west-1.amazonaws.com/lvs/TEST_MIX.mp3\",\n \"tags\": [\n \"September Event 2024\",\n \"2024\",\n \"Seniors\"\n ],\n \"licenseDetails\": [\n {\n \"licenseSource\": \"Other\",\n \"licenseSourceName\": \"Other Platform\",\n \"licenseFileURLs\": [\"https://clicknclear-public-resources.s3.eu-west-1.amazonaws.com/lvs/TEST_LICENSE.pdf\"]\n }\n ]\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{lvsURL}}/api/public/v1/verification-job", "host": [ "{{lvsURL}}" ], "path": [ "api", "public", "v1", "verification-job" ] }, "description": "### Create Verification Job\n\nThe create verification job endpoint can match and verify audio or video files against the provided licensing information and any ClicknClear licenses. \nClicknClear licenses will be fetched automatically based on the provided email address.\n\nAny songs found in the audio file will be matched against the license files provided. \nThe verification job process is asynchronous, on creation, you will receive the job with an ID, you can use this to poll the Get Verification Job Endpoint or you can set a webhook (preferred) for the 'Verification Job - Status Update' event, this event is fired when the job finishes processing. To setup a webhook please see the online documentation: [https://docs.clicknclear.com/verification/webhooks](https://docs.clicknclear.com/verification/webhooks)\n\nThe 'Verification Job - Status Update' webhook event is invoked with a minimal payload, the full verification job can then be fetched using the Get Verification Job endpoint. See 'IVerificationJobStatusUpdateV1' for the payload type.\n\nFor details on return types and the request payload please see the annotated typescript types: [https://github.com/ClicknClear/Public-Resources/blob/main/packages/lvs-types/src/v1/verificationJob.ts](https://github.com/ClicknClear/Public-Resources/blob/main/packages/lvs-types/src/v1/verificationJob.ts)" }, "response": [ { "name": "Create Verification Job", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\n \"name\": \"Tristan Barlow\",\n \"email\": \"tristan@clicknclear.com\",\n \"requiredTerritories\": [\n \"US\",\n \"GB\"\n ],\n \"startDate\": \"2024-09-01\",\n \"endDate\": \"2024-09-04\",\n \"externalId\": \"1234567890\",\n \"organisationId\": 1,\n \"audioFileURL\": \"https://clicknclear-public-resources.s3.eu-west-1.amazonaws.com/lvs/TEST_MIX.mp3\",\n \"tags\": [\n \"September Event 2024\",\n \"2024\",\n \"Seniors\"\n ],\n \"licenseDetails\": [\n {\n \"licenseSource\": \"Other\",\n \"licenseSourceName\": \"Other Platform\",\n \"licenseFileURLs\": [\"https://clicknclear-public-resources.s3.eu-west-1.amazonaws.com/lvs/TEST_LICENSE.pdf\"]\n }\n ]\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{lvsURL}}/api/public/v1/verification-job", "host": [ "{{lvsURL}}" ], "path": [ "api", "public", "v1", "verification-job" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Access-Control-Allow-Origin", "value": "*" }, { "key": "content-type", "value": "application/json; charset=utf-8" }, { "key": "content-length", "value": "348" }, { "key": "date", "value": "Mon, 16 Sep 2024 16:45:08 GMT" }, { "key": "connection", "value": "close" } ], "cookie": [], "body": "{\n \"id\": 4,\n \"name\": \"Tristan Barlow\",\n \"email\": \"tristan@clicknclear.com\",\n \"requiredTerritories\": [\n \"US\",\n \"GB\"\n ],\n \"externalId\": \"1234567890\",\n \"organisationId\": 1,\n \"soundRecordingId\": null,\n \"errorMessage\": \"\",\n \"status\": \"Created\",\n \"endDate\": \"2024-09-04T00:00:00.000Z\",\n \"startDate\": \"2024-09-01T00:00:00.000Z\",\n \"tags\": [\n \"September Event 2024\",\n \"2024\",\n \"Seniors\"\n ],\n \"recording\": null\n}" } ] }, { "name": "Get Verification Job", "request": { "method": "GET", "header": [], "url": { "raw": "{{lvsURL}}/api/public/v1/verification-job/:verificationJobId", "host": [ "{{lvsURL}}" ], "path": [ "api", "public", "v1", "verification-job", ":verificationJobId" ], "variable": [ { "key": "verificationJobId", "value": "4" } ] }, "description": "The get verification job endpoint can be used to get a single verification job from its ID.\n\nThe verification job is returned in full including any and all licensing data.\n\nTo view the response type please see: [https://github.com/ClicknClear/Public-Resources/blob/main/packages/lvs-types/src/v1/verificationJob.ts](https://github.com/ClicknClear/Public-Resources/blob/main/packages/lvs-types/src/v1/verificationJob.ts)." }, "response": [ { "name": "Get Verification Job", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{lvsURL}}/api/public/v1/verification-job/:verificationJobId", "host": [ "{{lvsURL}}" ], "path": [ "api", "public", "v1", "verification-job", ":verificationJobId" ], "variable": [ { "key": "verificationJobId", "value": "4" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Access-Control-Allow-Origin", "value": "*" }, { "key": "content-type", "value": "application/json; charset=utf-8" }, { "key": "content-length", "value": "2485" }, { "key": "date", "value": "Tue, 17 Sep 2024 07:31:45 GMT" }, { "key": "connection", "value": "close" } ], "cookie": [], "body": "{\n \"id\": 4,\n \"name\": \"Tristan Barlow\",\n \"email\": \"tristan@clicknclear.com\",\n \"requiredTerritories\": [\n \"US\",\n \"GB\"\n ],\n \"externalId\": \"1234567890\",\n \"organisationId\": 1,\n \"soundRecordingId\": 133,\n \"errorMessage\": \"\",\n \"status\": \"Completed\",\n \"endDate\": \"2024-09-04T00:00:00.000Z\",\n \"startDate\": \"2024-09-01T00:00:00.000Z\",\n \"tags\": [\n \"September Event 2024\",\n \"2024\",\n \"Seniors\"\n ],\n \"recording\": {\n \"createdAt\": \"2024-09-16T16:45:09.298Z\",\n \"downloadURL\": \"https://cnc-sound-recordings-staging.s3.eu-west-1.amazonaws.com/9fe09e66082651af69024a566a7fd0b9.mp3?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIATK64JFLFLBA4EBGI%2F20240917%2Feu-west-1%2Fs3%2Faws4_request&X-Amz-Date=20240917T073145Z&X-Amz-Expires=216000&X-Amz-Signature=4fe92aaa9729555b583cc527c2dca012a88fbe003286de24facf89aabac587d6&X-Amz-SignedHeaders=host&response-content-disposition=attachment%3B%20filename%20%3D%22verification-jobs%2F845dae593a60280092554d2e125b3db7.mp3%22&response-content-type=audio%2Fmpeg&x-id=GetObject\",\n \"uploadFileName\": \"verification-jobs/845dae593a60280092554d2e125b3db7.mp3\",\n \"licenseStatus\": \"Unverified\",\n \"songsConfirmedAt\": null,\n \"updatedAt\": \"2024-09-16T16:45:17.000Z\",\n \"status\": \"Complete\",\n \"songs\": [\n {\n \"title\": \"Start a Fire\",\n \"artists\": \"Who's Molly?\",\n \"endTime\": 20,\n \"startTime\": 0,\n \"cncMixId\": null,\n \"cncId\": \"5f0470bfb11d420440942a35\",\n \"composer\": null,\n \"isrc\": \"GB89R1600173\",\n \"iswc\": null,\n \"publisher\": null,\n \"recordLabel\": null,\n \"tunecode\": null,\n \"yearOfRelease\": null,\n \"upc\": \"5054526103603\",\n \"manualStatus\": null,\n \"licenseStatus\": \"Unverified\",\n \"licenseChecks\": {\n \"Publishing Adaptation Rights\": \"Unknown\",\n \"Publishing Duplication Rights\": \"Unknown\",\n \"Publishing Choreography Rights\": \"Unknown\",\n \"Title Matches\": \"Unknown\",\n \"Artists Match\": \"Unknown\",\n \"Full Ownership\": \"Unknown\",\n \"Valid Date\": \"Unknown\",\n \"License Source Matches\": \"Unknown\",\n \"Licensee Name Match\": \"Rejected\",\n \"Territory Match\": {\n \"US\": \"Unknown\",\n \"GB\": \"Unknown\"\n }\n },\n \"licenseData\": {\n \"bespokeAgreement\": null,\n \"licenseSource\": \"Other\",\n \"cncLicense\": null,\n \"externalLicense\": {\n \"id\": 133,\n \"sourceName\": \"Other Platform\",\n \"files\": [\n {\n \"id\": 104,\n \"downloadURL\": \"http://lvs.local.clicknclear.com:3001/api/files/download?t=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJidWNrZXQiOiJjbGlja25jbGVhci12ZXJpZmljYXRpb24tbGljZW5zZXMtc3RhZ2luZyIsImtleSI6ImV4dGVybmFsLWxpY2Vuc2VzL2MxOTg2MjBlZGYyMmI5YzM3ZDRiNjliNjMyOWY1NDNlLnBkZiIsImZpbGVuYW1lIjoiVW5rbm93bi5wZGYiLCJjb250ZW50VHlwZSI6ImFwcGxpY2F0aW9uL3BkZiIsImlhdCI6MTcyNjU1ODMwNSwiZXhwIjoxNzI2NjQ0NzA1fQ.sJXEJbXqDSXXZheAxRKSts9WaywT3A-VlT5HlEO9aVY\"\n }\n ]\n },\n \"publicDomainProof\": null\n }\n }\n ]\n }\n}" } ] }, { "name": "Search Verification Jobs", "request": { "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\n \"tags\": [\n \"2024\",\n \"Seniors\"\n ],\n \"statuses\": [\n \"Completed\",\n \"Created\"\n ],\n \"limit\": 2,\n \"offset\": 2\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{lvsURL}}/api/public/v1/verification-job/search", "host": [ "{{lvsURL}}" ], "path": [ "api", "public", "v1", "verification-job", "search" ] }, "description": "### Search Verification Jobs by Tag\n\nThe Search Verification Job by Tag endpoint allows you to retrieve a paginated list of verification jobs your organisation has submitted, filtered by tags.\n\nThe endpoint will return verification jobs that match ALL tags provided in the query.\n\nIt searches the Tags that were added to the Verification Job at the time of creation (via the Create Verification Job endpoint), returning a paginated list as well as a count of the total number of matched job records. If an empty tags array is passed (\\[\\]), all of your Verification Jobs will be returned.\n\nThe search endpoint will also accept an array of Job Statuses to further narrow the results to return only Verification Jobs with the requested status(s).\n\nPassing an orgId will narrow search to jobs within the specified organization. If undefined, all of a users' organizations will be searched. To find your organisation IDs please refer to the 'Get My Organisations' request in the postman documentation.\n\nPagination is achieved with 'limit' and 'offset'. If omitted they will default to 25 and 0 respectively. The endpoint returns an object containing an array of Verification Jobs as well as the total count of all matches ({results, count}: VerificationJobTagSearchResultsV1). Please consider that if you have many matching Verification Jobs, you may only receive the first page of results (eg 25) while the count of all matching results may be much higher. This allows you to effectively paginate.\n\nFor details on return type (VerificationJobTagSearchResultsV1) and the request payload (VerificationJobTagSearchV1) please see the annotated typescript types: [https://github.com/ClicknClear/Public-Resources/blob/main/packages/lvs-types/src/v1/verificationJob.ts](https://github.com/ClicknClear/Public-Resources/blob/main/packages/lvs-types/src/v1/verificationJob.ts)" }, "response": [ { "name": "Search Verification Jobs", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\n \"tags\": [\n \"2024\",\n \"Seniors\"\n ],\n \"statuses\": [\n \"Completed\",\n \"Created\"\n ],\n \"limit\": 2,\n \"offset\": 2\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{lvsURL}}/api/public/v1/verification-job/search", "host": [ "{{lvsURL}}" ], "path": [ "api", "public", "v1", "verification-job", "search" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "content-type", "value": "application/json; charset=utf-8" }, { "key": "content-length", "value": "3690" }, { "key": "Date", "value": "Wed, 09 Oct 2024 14:58:03 GMT" }, { "key": "Connection", "value": "keep-alive" }, { "key": "Keep-Alive", "value": "timeout=300" } ], "cookie": [], "body": "{\n \"jobs\": [\n {\n \"id\": 3,\n \"name\": \"Tristan Barlow\",\n \"email\": \"tristan@clicknclear.com\",\n \"requiredTerritories\": [\n \"US\",\n \"GB\"\n ],\n \"externalId\": \"1234567890\",\n \"organisationId\": 1,\n \"soundRecordingId\": 145,\n \"errorMessage\": \"\",\n \"status\": \"Completed\",\n \"endDate\": \"2024-09-04T00:00:00.000Z\",\n \"startDate\": \"2024-09-01T00:00:00.000Z\",\n \"tags\": [\n \"September Event 2024\",\n \"2024\",\n \"Seniors\"\n ],\n \"recording\": {\n \"createdAt\": \"2024-09-17T13:55:09.296Z\",\n \"downloadURL\": \"https://cnc-sound-recordings-staging.s3.eu-west-1.amazonaws.com/9fe09e66082651af69024a566a7fd0b9.mp3?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIATK64JFLFHXMJQUWO%2F20241009%2Feu-west-1%2Fs3%2Faws4_request&X-Amz-Date=20241009T145803Z&X-Amz-Expires=216000&X-Amz-Signature=591806e89f85ba6a7093f124ddfd55fd7c54497bd506eb35e0f8dea8f7885a13&X-Amz-SignedHeaders=host&response-content-disposition=attachment%3B%20filename%20%3D%22verification-jobs%2F845dae593a60280092554d2e125b3db7.mp3%22&response-content-type=audio%2Fmpeg&x-id=GetObject\",\n \"uploadFileName\": \"verification-jobs/845dae593a60280092554d2e125b3db7.mp3\",\n \"licenseStatus\": \"Unverified\",\n \"songsConfirmedAt\": null,\n \"updatedAt\": \"2024-09-17T13:55:09.000Z\",\n \"status\": \"Failed\",\n \"songs\": []\n }\n },\n {\n \"id\": 4,\n \"name\": \"Tristan Barlow\",\n \"email\": \"tristan@clicknclear.com\",\n \"requiredTerritories\": [\n \"US\",\n \"GB\"\n ],\n \"externalId\": \"1234567890\",\n \"organisationId\": 1,\n \"soundRecordingId\": 146,\n \"errorMessage\": \"\",\n \"status\": \"Completed\",\n \"endDate\": \"2024-09-04T00:00:00.000Z\",\n \"startDate\": \"2024-09-01T00:00:00.000Z\",\n \"tags\": [\n \"September Event 2024\",\n \"2024\",\n \"Seniors\",\n \"Test\"\n ],\n \"recording\": {\n \"createdAt\": \"2024-09-17T16:20:15.049Z\",\n \"downloadURL\": \"https://cnc-sound-recordings-staging.s3.eu-west-1.amazonaws.com/9fe09e66082651af69024a566a7fd0b9.mp3?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIATK64JFLFHXMJQUWO%2F20241009%2Feu-west-1%2Fs3%2Faws4_request&X-Amz-Date=20241009T145803Z&X-Amz-Expires=216000&X-Amz-Signature=591806e89f85ba6a7093f124ddfd55fd7c54497bd506eb35e0f8dea8f7885a13&X-Amz-SignedHeaders=host&response-content-disposition=attachment%3B%20filename%20%3D%22verification-jobs%2F845dae593a60280092554d2e125b3db7.mp3%22&response-content-type=audio%2Fmpeg&x-id=GetObject\",\n \"uploadFileName\": \"verification-jobs/845dae593a60280092554d2e125b3db7.mp3\",\n \"licenseStatus\": \"Unverified\",\n \"songsConfirmedAt\": null,\n \"updatedAt\": \"2024-09-17T16:20:22.000Z\",\n \"status\": \"Complete\",\n \"songs\": [\n {\n \"title\": \"Start a Fire\",\n \"artists\": \"Who's Molly?\",\n \"endTime\": 20,\n \"startTime\": 0,\n \"cncMixId\": null,\n \"cncId\": \"5f0470bfb11d420440942a35\",\n \"composer\": null,\n \"isrc\": \"GB89R1600173\",\n \"iswc\": null,\n \"publisher\": null,\n \"recordLabel\": null,\n \"tunecode\": null,\n \"yearOfRelease\": null,\n \"upc\": \"5054526103603\",\n \"manualStatus\": null,\n \"licenseStatus\": \"Unverified\",\n \"licenseChecks\": {\n \"Publishing Adaptation Rights\": \"Unknown\",\n \"Publishing Duplication Rights\": \"Unknown\",\n \"Publishing Choreography Rights\": \"Unknown\",\n \"Title Matches\": \"Unknown\",\n \"Artists Match\": \"Unknown\",\n \"Full Ownership\": \"Unknown\",\n \"Valid Date\": \"Unknown\",\n \"License Source Matches\": \"Unknown\",\n \"Licensee Name Match\": \"Rejected\",\n \"Territory Match\": {\n \"US\": \"Unknown\",\n \"GB\": \"Unknown\"\n }\n },\n \"licenseData\": {\n \"bespokeAgreement\": null,\n \"licenseSource\": \"Other\",\n \"cncLicense\": null,\n \"externalLicense\": {\n \"id\": 134,\n \"sourceName\": \"Other Platform\",\n \"files\": [\n {\n \"id\": 106,\n \"downloadURL\": \"http://lvs.local.clicknclear.com:3001/api/files/download?t=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJidWNrZXQiOiJjbGlja25jbGVhci12ZXJpZmljYXRpb24tbGljZW5zZXMtc3RhZ2luZyIsImtleSI6ImV4dGVybmFsLWxpY2Vuc2VzL2MxOTg2MjBlZGYyMmI5YzM3ZDRiNjliNjMyOWY1NDNlLnBkZiIsImZpbGVuYW1lIjoiVW5rbm93bi5wZGYiLCJjb250ZW50VHlwZSI6ImFwcGxpY2F0aW9uL3BkZiIsImlhdCI6MTcyODQ4NTg4MywiZXhwIjoxNzI4NTcyMjgzfQ.Xfy77XHSaNdKIMrf7GZzjnW_FPRI684XKGbNjPzyar4\"\n }\n ]\n },\n \"publicDomainProof\": null\n }\n }\n ]\n }\n }\n ],\n \"count\": 4\n}" } ] } ], "description": "This folder contains all of the requests for verification jobs and their related entities" }, { "name": "Events V1", "item": [ { "name": "Get Entries", "request": { "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\n \"fields\": [],\n \"updatedAfter\": \"2024-10-16:20:00.000Z\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{lvsURL}}/api/public/v1/event/:id/entries", "host": [ "{{lvsURL}}" ], "path": [ "api", "public", "v1", "event", ":id", "entries" ], "variable": [ { "key": "id", "value": "52" } ] }, "description": "The Get Event Entries API endpoint can be used to get event entries along with any licensing data.\n\nThe shape of the result body can be found starting in: [https://github.com/ClicknClear/Public-Resources/blob/main/packages/lvs-types/src/v1/entry.ts](https://github.com/ClicknClear/Public-Resources/blob/main/packages/lvs-types/src/v1/entry.ts) \nwith the IEntryV1 type. Due to the complex return type the exact types are spread amongst a few different files. \nThis endpoint has an optional request body which can be used to filter down the results. If no body is supplied it will return all results. By supplying the body, you can filter based on the updatedAfter or by the signup field responses. The zod schemas can be found in this file: [https://github.com/ClicknClear/Public-Resources/blob/main/packages/lvs-types/src/v1/entry.ts](https://github.com/ClicknClear/Public-Resources/blob/main/packages/lvs-types/src/v1/entry.ts) and it is called getEntriesQuerySchemaV1." }, "response": [ { "name": "All Entries", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{lvsURL}}/api/public/v1/event/:id/entries", "host": [ "{{lvsURL}}" ], "path": [ "api", "public", "v1", "event", ":id", "entries" ], "variable": [ { "key": "id", "value": "52" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Access-Control-Allow-Origin", "value": "*" }, { "key": "content-type", "value": "application/json; charset=utf-8" }, { "key": "content-length", "value": "6149" }, { "key": "date", "value": "Thu, 17 Oct 2024 16:17:08 GMT" }, { "key": "connection", "value": "close" } ], "cookie": [], "body": "[\n {\n \"id\": 283,\n \"email\": \"tristan+test@clicknclear.com\",\n \"name\": \"Leopards\",\n \"fields\": [\n {\n \"value\": \"Group\",\n \"signupFieldId\": 90,\n \"key\": \"division\"\n },\n {\n \"value\": \"111111111\",\n \"signupFieldId\": 91,\n \"key\": \"externalId\"\n },\n {\n \"value\": \"Open\",\n \"signupFieldId\": 92,\n \"key\": \"ageGroup\"\n }\n ],\n \"soundRecording\": null\n },\n {\n \"id\": 280,\n \"email\": \"tristan+test@clicknclear.com\",\n \"name\": \"Tigers Jr\",\n \"fields\": [\n {\n \"value\": \"Group\",\n \"signupFieldId\": 90,\n \"key\": \"division\"\n },\n {\n \"value\": \"123456789\",\n \"signupFieldId\": 91,\n \"key\": \"externalId\"\n },\n {\n \"value\": \"Juniors\",\n \"signupFieldId\": 92,\n \"key\": \"ageGroup\"\n }\n ],\n \"soundRecording\": {\n \"createdAt\": \"2024-10-14T12:59:07.299Z\",\n \"downloadURL\": \"https://cnc-sound-recordings-staging.s3.eu-west-1.amazonaws.com/8a05fd9c8bd0c3909f19ade7adc0340d.mp3?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIATK64JFLFLBA4EBGI%2F20241017%2Feu-west-1%2Fs3%2Faws4_request&X-Amz-Date=20241017T161708Z&X-Amz-Expires=216000&X-Amz-Signature=08a94c929a45b1d961fd64f848a7bbd50c0c9a4f079e9e1a02b986435d7de7ac&X-Amz-SignedHeaders=host&response-content-disposition=attachment%3B%20filename%20%3D%22Jaewynn_Spice_Girl.mp3%22&response-content-type=audio%2Fmpeg&x-id=GetObject\",\n \"uploadFileName\": \"Jaewynn_Spice_Girl.mp3\",\n \"licenseStatus\": \"Licensed\",\n \"songsConfirmedAt\": \"2024-10-17T14:41:56.000Z\",\n \"updatedAt\": \"2024-10-17T14:41:56.000Z\",\n \"status\": \"Complete\",\n \"songs\": [\n {\n \"title\": \"Spice Girl\",\n \"artists\": \"Jaewynn\",\n \"endTime\": 60,\n \"startTime\": 0,\n \"cncMixId\": null,\n \"cncId\": \"5efcbb6ab11d4204406d8f59\",\n \"composer\": null,\n \"isrc\": null,\n \"iswc\": null,\n \"publisher\": null,\n \"recordLabel\": \"Max Music Ltd\",\n \"tunecode\": null,\n \"yearOfRelease\": null,\n \"upc\": null,\n \"manualStatus\": null,\n \"licenseStatus\": \"Licensed\",\n \"licenseChecks\": {\n \"Licensee Name Match\": \"Accepted\",\n \"License Source Matches\": \"Accepted\",\n \"Title Matches\": \"Accepted\",\n \"Artists Match\": \"Accepted\",\n \"Master Choreography Rights\": \"Accepted\",\n \"Master Adaptation Rights\": \"Accepted\",\n \"Master Duplication Rights\": \"Accepted\",\n \"Publishing Choreography Rights\": \"Accepted\",\n \"Publishing Adaptation Rights\": \"Accepted\",\n \"Publishing Duplication Rights\": \"Accepted\",\n \"Valid Date\": \"Accepted\",\n \"Full Ownership\": \"Accepted\",\n \"Territory Match\": {\n \"US\": \"Accepted\"\n }\n },\n \"licenseData\": {\n \"bespokeAgreement\": null,\n \"licenseSource\": \"ClicknClear\",\n \"cncLicense\": null,\n \"externalLicense\": null,\n \"publicDomainProof\": null\n }\n }\n ]\n }\n },\n {\n \"id\": 282,\n \"email\": \"tristan+test@clicknclear.com\",\n \"name\": \"Tigers Open\",\n \"fields\": [\n {\n \"value\": \"Group\",\n \"signupFieldId\": 90,\n \"key\": \"division\"\n },\n {\n \"value\": \"9292929292\",\n \"signupFieldId\": 91,\n \"key\": \"externalId\"\n },\n {\n \"value\": \"Open\",\n \"signupFieldId\": 92,\n \"key\": \"ageGroup\"\n }\n ],\n \"soundRecording\": {\n \"createdAt\": \"2023-04-06T06:59:33.230Z\",\n \"downloadURL\": \"https://cnc-sound-recordings-staging.s3.eu-west-1.amazonaws.com/46ff01e352c4be737f2429be07e5f5cc.mpga?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIATK64JFLFLBA4EBGI%2F20241017%2Feu-west-1%2Fs3%2Faws4_request&X-Amz-Date=20241017T161708Z&X-Amz-Expires=216000&X-Amz-Signature=b1b7d5140540376ac565cbbdeb541f86aba9a63d6d98541ec105029043099128&X-Amz-SignedHeaders=host&response-content-disposition=attachment%3B%20filename%20%3D%22example.mpga%22&response-content-type=audio%2Fmpeg&x-id=GetObject\",\n \"uploadFileName\": \"example.mpga\",\n \"licenseStatus\": \"Pending\",\n \"songsConfirmedAt\": \"2024-10-17T14:51:32.000Z\",\n \"updatedAt\": \"2024-10-17T14:51:32.000Z\",\n \"status\": \"Failed\",\n \"songs\": [\n {\n \"title\": \"Custom Song For Tigers\",\n \"artists\": \"Harry Wilson\",\n \"endTime\": 35,\n \"startTime\": 0,\n \"cncMixId\": null,\n \"cncId\": null,\n \"composer\": \"Harry Wilson\",\n \"isrc\": null,\n \"iswc\": null,\n \"publisher\": \"N/A\",\n \"recordLabel\": \"\",\n \"tunecode\": null,\n \"yearOfRelease\": 2024,\n \"upc\": null,\n \"manualStatus\": null,\n \"licenseStatus\": \"Pending\",\n \"licenseChecks\": {\n \"Licensee Name Match\": \"Unknown\",\n \"License Source Matches\": \"Unknown\",\n \"Title Matches\": \"Unknown\",\n \"Artists Match\": \"Unknown\",\n \"Master Choreography Rights\": \"Unknown\",\n \"Master Adaptation Rights\": \"Unknown\",\n \"Master Duplication Rights\": \"Unknown\",\n \"Publishing Choreography Rights\": \"Unknown\",\n \"Publishing Adaptation Rights\": \"Unknown\",\n \"Publishing Duplication Rights\": \"Unknown\",\n \"Valid Date\": \"Unknown\",\n \"Full Ownership\": \"Unknown\",\n \"Territory Match\": {\n \"US\": \"Unknown\"\n }\n },\n \"licenseData\": {\n \"bespokeAgreement\": null,\n \"licenseSource\": \"Bespoke Music\",\n \"cncLicense\": null,\n \"externalLicense\": null,\n \"publicDomainProof\": null\n }\n }\n ]\n }\n },\n {\n \"id\": 281,\n \"email\": \"tristan+test@clicknclear.com\",\n \"name\": \"Tigers Sr\",\n \"fields\": [\n {\n \"value\": \"Group\",\n \"signupFieldId\": 90,\n \"key\": \"division\"\n },\n {\n \"value\": \"1234567890\",\n \"signupFieldId\": 91,\n \"key\": \"externalId\"\n },\n {\n \"value\": \"Seniors\",\n \"signupFieldId\": 92,\n \"key\": \"ageGroup\"\n }\n ],\n \"soundRecording\": {\n \"createdAt\": \"2023-07-28T14:55:03.636Z\",\n \"downloadURL\": \"https://cnc-sound-recordings-staging.s3.eu-west-1.amazonaws.com/fec78481becc4388ac8e8ec1a2a7dd98.mp3?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIATK64JFLFLBA4EBGI%2F20241017%2Feu-west-1%2Fs3%2Faws4_request&X-Amz-Date=20241017T161708Z&X-Amz-Expires=216000&X-Amz-Signature=690a22fab7bb3a64f38a1a36e686f6192645d765826162bb0e317f60b4cf25b2&X-Amz-SignedHeaders=host&response-content-disposition=attachment%3B%20filename%20%3D%22MY_MIX_WITH_MATCHES.mp3%22&response-content-type=audio%2Fmpeg&x-id=GetObject\",\n \"uploadFileName\": \"MY_MIX_WITH_MATCHES.mp3\",\n \"licenseStatus\": \"Unverified\",\n \"songsConfirmedAt\": \"2024-10-17T14:48:53.000Z\",\n \"updatedAt\": \"2024-10-17T14:48:53.000Z\",\n \"status\": \"Failed\",\n \"songs\": [\n {\n \"title\": \"Going My Way\",\n \"artists\": \"Will Young\",\n \"endTime\": 156,\n \"startTime\": 0,\n \"cncMixId\": null,\n \"cncId\": \"5f387fec30ab2475052fb73e\",\n \"composer\": null,\n \"isrc\": null,\n \"iswc\": null,\n \"publisher\": null,\n \"recordLabel\": \"Sony BMG Music Entertainment\",\n \"tunecode\": null,\n \"yearOfRelease\": 2003,\n \"upc\": null,\n \"manualStatus\": null,\n \"licenseStatus\": \"Unverified\",\n \"licenseChecks\": {\n \"Licensee Name Match\": \"Unknown\",\n \"License Source Matches\": \"Unknown\",\n \"Title Matches\": \"Unknown\",\n \"Artists Match\": \"Unknown\",\n \"Master Choreography Rights\": \"Unknown\",\n \"Master Adaptation Rights\": \"Unknown\",\n \"Master Duplication Rights\": \"Unknown\",\n \"Publishing Choreography Rights\": \"Unknown\",\n \"Publishing Adaptation Rights\": \"Unknown\",\n \"Publishing Duplication Rights\": \"Unknown\",\n \"Valid Date\": \"Unknown\",\n \"Full Ownership\": \"Unknown\",\n \"Territory Match\": {\n \"US\": \"Unknown\"\n }\n },\n \"licenseData\": {\n \"bespokeAgreement\": null,\n \"licenseSource\": \"Pending License\",\n \"cncLicense\": null,\n \"externalLicense\": null,\n \"publicDomainProof\": null\n }\n }\n ]\n }\n }\n]" }, { "name": "Filter By Signup Field", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\n \"fields\": [\n {\n \"key\": \"externalId\",\n \"value\": \"1234567890\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{lvsURL}}/api/public/v1/event/:id/entries", "host": [ "{{lvsURL}}" ], "path": [ "api", "public", "v1", "event", ":id", "entries" ], "variable": [ { "key": "id", "value": "52" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Access-Control-Allow-Origin", "value": "*" }, { "key": "content-type", "value": "application/json; charset=utf-8" }, { "key": "content-length", "value": "1986" }, { "key": "date", "value": "Thu, 17 Oct 2024 16:18:09 GMT" }, { "key": "connection", "value": "close" } ], "cookie": [], "body": "[\n {\n \"id\": 281,\n \"email\": \"tristan+test@clicknclear.com\",\n \"name\": \"Tigers Sr\",\n \"fields\": [\n {\n \"value\": \"Group\",\n \"signupFieldId\": 90,\n \"key\": \"division\"\n },\n {\n \"value\": \"1234567890\",\n \"signupFieldId\": 91,\n \"key\": \"externalId\"\n },\n {\n \"value\": \"Seniors\",\n \"signupFieldId\": 92,\n \"key\": \"ageGroup\"\n }\n ],\n \"soundRecording\": {\n \"createdAt\": \"2023-07-28T14:55:03.636Z\",\n \"downloadURL\": \"https://cnc-sound-recordings-staging.s3.eu-west-1.amazonaws.com/fec78481becc4388ac8e8ec1a2a7dd98.mp3?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIATK64JFLFLBA4EBGI%2F20241017%2Feu-west-1%2Fs3%2Faws4_request&X-Amz-Date=20241017T161809Z&X-Amz-Expires=216000&X-Amz-Signature=e0d5a390c6ee4b3fe30c7c5d97581cea563b52a867aa40fe9b74d0679e778f61&X-Amz-SignedHeaders=host&response-content-disposition=attachment%3B%20filename%20%3D%22MY_MIX_WITH_MATCHES.mp3%22&response-content-type=audio%2Fmpeg&x-id=GetObject\",\n \"uploadFileName\": \"MY_MIX_WITH_MATCHES.mp3\",\n \"licenseStatus\": \"Unverified\",\n \"songsConfirmedAt\": \"2024-10-17T14:48:53.000Z\",\n \"updatedAt\": \"2024-10-17T14:48:53.000Z\",\n \"status\": \"Failed\",\n \"songs\": [\n {\n \"title\": \"Going My Way\",\n \"artists\": \"Will Young\",\n \"endTime\": 156,\n \"startTime\": 0,\n \"cncMixId\": null,\n \"cncId\": \"5f387fec30ab2475052fb73e\",\n \"composer\": null,\n \"isrc\": null,\n \"iswc\": null,\n \"publisher\": null,\n \"recordLabel\": \"Sony BMG Music Entertainment\",\n \"tunecode\": null,\n \"yearOfRelease\": 2003,\n \"upc\": null,\n \"manualStatus\": null,\n \"licenseStatus\": \"Unverified\",\n \"licenseChecks\": {\n \"Licensee Name Match\": \"Unknown\",\n \"License Source Matches\": \"Unknown\",\n \"Title Matches\": \"Unknown\",\n \"Artists Match\": \"Unknown\",\n \"Master Choreography Rights\": \"Unknown\",\n \"Master Adaptation Rights\": \"Unknown\",\n \"Master Duplication Rights\": \"Unknown\",\n \"Publishing Choreography Rights\": \"Unknown\",\n \"Publishing Adaptation Rights\": \"Unknown\",\n \"Publishing Duplication Rights\": \"Unknown\",\n \"Valid Date\": \"Unknown\",\n \"Full Ownership\": \"Unknown\",\n \"Territory Match\": {\n \"US\": \"Unknown\"\n }\n },\n \"licenseData\": {\n \"bespokeAgreement\": null,\n \"licenseSource\": \"Pending License\",\n \"cncLicense\": null,\n \"externalLicense\": null,\n \"publicDomainProof\": null\n }\n }\n ]\n }\n }\n]" }, { "name": "Filter By Updated After", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\n \"fields\": [],\n \"updatedAfter\": \"2024-10-16:20:00.000Z\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{lvsURL}}/api/public/v1/event/:id/entries", "host": [ "{{lvsURL}}" ], "path": [ "api", "public", "v1", "event", ":id", "entries" ], "variable": [ { "key": "id", "value": "52" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Access-Control-Allow-Origin", "value": "*" }, { "key": "content-type", "value": "application/json; charset=utf-8" }, { "key": "content-length", "value": "6149" }, { "key": "date", "value": "Thu, 17 Oct 2024 16:19:40 GMT" }, { "key": "connection", "value": "close" } ], "cookie": [], "body": "[\n {\n \"id\": 283,\n \"email\": \"tristan+test@clicknclear.com\",\n \"name\": \"Leopards\",\n \"fields\": [\n {\n \"value\": \"Group\",\n \"signupFieldId\": 90,\n \"key\": \"division\"\n },\n {\n \"value\": \"111111111\",\n \"signupFieldId\": 91,\n \"key\": \"externalId\"\n },\n {\n \"value\": \"Open\",\n \"signupFieldId\": 92,\n \"key\": \"ageGroup\"\n }\n ],\n \"soundRecording\": null\n },\n {\n \"id\": 280,\n \"email\": \"tristan+test@clicknclear.com\",\n \"name\": \"Tigers Jr\",\n \"fields\": [\n {\n \"value\": \"Group\",\n \"signupFieldId\": 90,\n \"key\": \"division\"\n },\n {\n \"value\": \"123456789\",\n \"signupFieldId\": 91,\n \"key\": \"externalId\"\n },\n {\n \"value\": \"Juniors\",\n \"signupFieldId\": 92,\n \"key\": \"ageGroup\"\n }\n ],\n \"soundRecording\": {\n \"createdAt\": \"2024-10-14T12:59:07.299Z\",\n \"downloadURL\": \"https://cnc-sound-recordings-staging.s3.eu-west-1.amazonaws.com/8a05fd9c8bd0c3909f19ade7adc0340d.mp3?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIATK64JFLFLBA4EBGI%2F20241017%2Feu-west-1%2Fs3%2Faws4_request&X-Amz-Date=20241017T161940Z&X-Amz-Expires=216000&X-Amz-Signature=7fc57f6036ad0b8d100969aa893858a3aa0b6475233fcb801d16538d42a4a7cf&X-Amz-SignedHeaders=host&response-content-disposition=attachment%3B%20filename%20%3D%22Jaewynn_Spice_Girl.mp3%22&response-content-type=audio%2Fmpeg&x-id=GetObject\",\n \"uploadFileName\": \"Jaewynn_Spice_Girl.mp3\",\n \"licenseStatus\": \"Licensed\",\n \"songsConfirmedAt\": \"2024-10-17T14:41:56.000Z\",\n \"updatedAt\": \"2024-10-17T14:41:56.000Z\",\n \"status\": \"Complete\",\n \"songs\": [\n {\n \"title\": \"Spice Girl\",\n \"artists\": \"Jaewynn\",\n \"endTime\": 60,\n \"startTime\": 0,\n \"cncMixId\": null,\n \"cncId\": \"5efcbb6ab11d4204406d8f59\",\n \"composer\": null,\n \"isrc\": null,\n \"iswc\": null,\n \"publisher\": null,\n \"recordLabel\": \"Max Music Ltd\",\n \"tunecode\": null,\n \"yearOfRelease\": null,\n \"upc\": null,\n \"manualStatus\": null,\n \"licenseStatus\": \"Licensed\",\n \"licenseChecks\": {\n \"Licensee Name Match\": \"Accepted\",\n \"License Source Matches\": \"Accepted\",\n \"Title Matches\": \"Accepted\",\n \"Artists Match\": \"Accepted\",\n \"Master Choreography Rights\": \"Accepted\",\n \"Master Adaptation Rights\": \"Accepted\",\n \"Master Duplication Rights\": \"Accepted\",\n \"Publishing Choreography Rights\": \"Accepted\",\n \"Publishing Adaptation Rights\": \"Accepted\",\n \"Publishing Duplication Rights\": \"Accepted\",\n \"Valid Date\": \"Accepted\",\n \"Full Ownership\": \"Accepted\",\n \"Territory Match\": {\n \"US\": \"Accepted\"\n }\n },\n \"licenseData\": {\n \"bespokeAgreement\": null,\n \"licenseSource\": \"ClicknClear\",\n \"cncLicense\": null,\n \"externalLicense\": null,\n \"publicDomainProof\": null\n }\n }\n ]\n }\n },\n {\n \"id\": 282,\n \"email\": \"tristan+test@clicknclear.com\",\n \"name\": \"Tigers Open\",\n \"fields\": [\n {\n \"value\": \"Group\",\n \"signupFieldId\": 90,\n \"key\": \"division\"\n },\n {\n \"value\": \"9292929292\",\n \"signupFieldId\": 91,\n \"key\": \"externalId\"\n },\n {\n \"value\": \"Open\",\n \"signupFieldId\": 92,\n \"key\": \"ageGroup\"\n }\n ],\n \"soundRecording\": {\n \"createdAt\": \"2023-04-06T06:59:33.230Z\",\n \"downloadURL\": \"https://cnc-sound-recordings-staging.s3.eu-west-1.amazonaws.com/46ff01e352c4be737f2429be07e5f5cc.mpga?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIATK64JFLFLBA4EBGI%2F20241017%2Feu-west-1%2Fs3%2Faws4_request&X-Amz-Date=20241017T161940Z&X-Amz-Expires=216000&X-Amz-Signature=dcc167e199572f0467fe3e9ba08d4b7a168de20688c2b0e78e29791d2382c84c&X-Amz-SignedHeaders=host&response-content-disposition=attachment%3B%20filename%20%3D%22example.mpga%22&response-content-type=audio%2Fmpeg&x-id=GetObject\",\n \"uploadFileName\": \"example.mpga\",\n \"licenseStatus\": \"Pending\",\n \"songsConfirmedAt\": \"2024-10-17T14:51:32.000Z\",\n \"updatedAt\": \"2024-10-17T14:51:32.000Z\",\n \"status\": \"Failed\",\n \"songs\": [\n {\n \"title\": \"Custom Song For Tigers\",\n \"artists\": \"Harry Wilson\",\n \"endTime\": 35,\n \"startTime\": 0,\n \"cncMixId\": null,\n \"cncId\": null,\n \"composer\": \"Harry Wilson\",\n \"isrc\": null,\n \"iswc\": null,\n \"publisher\": \"N/A\",\n \"recordLabel\": \"\",\n \"tunecode\": null,\n \"yearOfRelease\": 2024,\n \"upc\": null,\n \"manualStatus\": null,\n \"licenseStatus\": \"Pending\",\n \"licenseChecks\": {\n \"Licensee Name Match\": \"Unknown\",\n \"License Source Matches\": \"Unknown\",\n \"Title Matches\": \"Unknown\",\n \"Artists Match\": \"Unknown\",\n \"Master Choreography Rights\": \"Unknown\",\n \"Master Adaptation Rights\": \"Unknown\",\n \"Master Duplication Rights\": \"Unknown\",\n \"Publishing Choreography Rights\": \"Unknown\",\n \"Publishing Adaptation Rights\": \"Unknown\",\n \"Publishing Duplication Rights\": \"Unknown\",\n \"Valid Date\": \"Unknown\",\n \"Full Ownership\": \"Unknown\",\n \"Territory Match\": {\n \"US\": \"Unknown\"\n }\n },\n \"licenseData\": {\n \"bespokeAgreement\": null,\n \"licenseSource\": \"Bespoke Music\",\n \"cncLicense\": null,\n \"externalLicense\": null,\n \"publicDomainProof\": null\n }\n }\n ]\n }\n },\n {\n \"id\": 281,\n \"email\": \"tristan+test@clicknclear.com\",\n \"name\": \"Tigers Sr\",\n \"fields\": [\n {\n \"value\": \"Group\",\n \"signupFieldId\": 90,\n \"key\": \"division\"\n },\n {\n \"value\": \"1234567890\",\n \"signupFieldId\": 91,\n \"key\": \"externalId\"\n },\n {\n \"value\": \"Seniors\",\n \"signupFieldId\": 92,\n \"key\": \"ageGroup\"\n }\n ],\n \"soundRecording\": {\n \"createdAt\": \"2023-07-28T14:55:03.636Z\",\n \"downloadURL\": \"https://cnc-sound-recordings-staging.s3.eu-west-1.amazonaws.com/fec78481becc4388ac8e8ec1a2a7dd98.mp3?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIATK64JFLFLBA4EBGI%2F20241017%2Feu-west-1%2Fs3%2Faws4_request&X-Amz-Date=20241017T161940Z&X-Amz-Expires=216000&X-Amz-Signature=fe24e875571446c180c0dbc8ec5407e169627dcbc8f4a43029c2d8c81dddd058&X-Amz-SignedHeaders=host&response-content-disposition=attachment%3B%20filename%20%3D%22MY_MIX_WITH_MATCHES.mp3%22&response-content-type=audio%2Fmpeg&x-id=GetObject\",\n \"uploadFileName\": \"MY_MIX_WITH_MATCHES.mp3\",\n \"licenseStatus\": \"Unverified\",\n \"songsConfirmedAt\": \"2024-10-17T14:48:53.000Z\",\n \"updatedAt\": \"2024-10-17T14:48:53.000Z\",\n \"status\": \"Failed\",\n \"songs\": [\n {\n \"title\": \"Going My Way\",\n \"artists\": \"Will Young\",\n \"endTime\": 156,\n \"startTime\": 0,\n \"cncMixId\": null,\n \"cncId\": \"5f387fec30ab2475052fb73e\",\n \"composer\": null,\n \"isrc\": null,\n \"iswc\": null,\n \"publisher\": null,\n \"recordLabel\": \"Sony BMG Music Entertainment\",\n \"tunecode\": null,\n \"yearOfRelease\": 2003,\n \"upc\": null,\n \"manualStatus\": null,\n \"licenseStatus\": \"Unverified\",\n \"licenseChecks\": {\n \"Licensee Name Match\": \"Unknown\",\n \"License Source Matches\": \"Unknown\",\n \"Title Matches\": \"Unknown\",\n \"Artists Match\": \"Unknown\",\n \"Master Choreography Rights\": \"Unknown\",\n \"Master Adaptation Rights\": \"Unknown\",\n \"Master Duplication Rights\": \"Unknown\",\n \"Publishing Choreography Rights\": \"Unknown\",\n \"Publishing Adaptation Rights\": \"Unknown\",\n \"Publishing Duplication Rights\": \"Unknown\",\n \"Valid Date\": \"Unknown\",\n \"Full Ownership\": \"Unknown\",\n \"Territory Match\": {\n \"US\": \"Unknown\"\n }\n },\n \"licenseData\": {\n \"bespokeAgreement\": null,\n \"licenseSource\": \"Pending License\",\n \"cncLicense\": null,\n \"externalLicense\": null,\n \"publicDomainProof\": null\n }\n }\n ]\n }\n }\n]" } ] }, { "name": "Get Events", "request": { "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\n \"limit\": 20,\n \"offset\": 20,\n \"organisationId\": 1\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{lvsURL}}/api/public/v1/event", "host": [ "{{lvsURL}}" ], "path": [ "api", "public", "v1", "event" ] }, "description": "The get events endpoint returns all events that the current user account has access to. This includes any events of child organisations.\n\nThis request can also be supplied an optional request body which can be used to filter the events returned.\n\nTo view the annotated Typescript response please go to: [https://github.com/ClicknClear/Public-Resources/blob/main/packages/lvs-types/src/v1/event.ts](https://github.com/ClicknClear/Public-Resources/blob/main/packages/lvs-types/src/v1/season.ts)\n\nThe getEventsQuerySchemaV1 schema describes the optional request body and the IEventV1 interface describes the response body." }, "response": [ { "name": "Get Events", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\n \"limit\": 20,\n \"offset\": 20,\n \"organisationId\": 1\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{lvsURL}}/api/public/v1/event", "host": [ "{{lvsURL}}" ], "path": [ "api", "public", "v1", "event" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Access-Control-Allow-Origin", "value": "*" }, { "key": "content-type", "value": "application/json; charset=utf-8" }, { "key": "content-length", "value": "4335" }, { "key": "date", "value": "Thu, 17 Oct 2024 15:29:15 GMT" }, { "key": "connection", "value": "close" } ], "cookie": [], "body": "[\n {\n \"id\": 16,\n \"isLocked\": false,\n \"organisationId\": 1,\n \"title\": \"Background Music - Copy\",\n \"territory\": \"GB\",\n \"endDate\": \"2023-11-01T00:00:00.000Z\",\n \"startDate\": \"2023-11-01T00:00:00.000Z\",\n \"inviteURL\": \"{{lvsURL}}/my-events/event/16/invite?token=64ce96f38f416924372233ff50f033b3\",\n \"signupFields\": []\n },\n {\n \"id\": 15,\n \"isLocked\": false,\n \"organisationId\": 1,\n \"title\": \"Background Music\",\n \"territory\": \"GB\",\n \"endDate\": \"2023-11-01T00:00:00.000Z\",\n \"startDate\": \"2023-11-01T00:00:00.000Z\",\n \"inviteURL\": \"{{lvsURL}}/my-events/event/15/invite?token=e4fd50dd1d5ed63b940afaad7054e19d\",\n \"signupFields\": []\n },\n {\n \"id\": 14,\n \"isLocked\": false,\n \"organisationId\": 1,\n \"title\": \"Test Event - Custom Questions 2\",\n \"territory\": \"GB\",\n \"endDate\": \"2023-10-25T00:00:00.000Z\",\n \"startDate\": \"2023-10-25T00:00:00.000Z\",\n \"inviteURL\": \"{{lvsURL}}/my-events/event/14/invite?token=ae27109bae0ea8316260b7ad1346053e\",\n \"signupFields\": [\n {\n \"id\": 32,\n \"isRequired\": true,\n \"options\": [],\n \"order\": 0,\n \"question\": \"Custom 1\",\n \"description\": \"\",\n \"type\": \"shortAnswer\",\n \"key\": null\n },\n {\n \"id\": 33,\n \"isRequired\": true,\n \"options\": [],\n \"order\": 1,\n \"question\": \"Custom 2\",\n \"description\": \"\",\n \"type\": \"shortAnswer\",\n \"key\": null\n }\n ]\n },\n {\n \"id\": 13,\n \"isLocked\": false,\n \"organisationId\": 1,\n \"title\": \"Test Event - Custom Questions\",\n \"territory\": \"GB\",\n \"endDate\": \"2023-10-25T00:00:00.000Z\",\n \"startDate\": \"2023-10-25T00:00:00.000Z\",\n \"inviteURL\": \"{{lvsURL}}/my-events/event/13/invite?token=5e02833843d1c1c8d60545b418ea5f03\",\n \"signupFields\": []\n },\n {\n \"id\": 11,\n \"isLocked\": false,\n \"organisationId\": 1,\n \"title\": \"Sound Recording Event\",\n \"territory\": \"GB\",\n \"endDate\": \"2023-03-29T00:00:00.000Z\",\n \"startDate\": \"2023-03-27T00:00:00.000Z\",\n \"inviteURL\": \"{{lvsURL}}/my-events/event/11/invite?token=cdfcc7c8d338d48ee1ca4d31b1b2027b\",\n \"signupFields\": []\n },\n {\n \"id\": 9,\n \"isLocked\": false,\n \"organisationId\": 1,\n \"title\": \"Example Event\",\n \"territory\": \"US\",\n \"endDate\": \"2023-03-19T00:00:00.000Z\",\n \"startDate\": \"2023-03-17T00:00:00.000Z\",\n \"inviteURL\": \"{{lvsURL}}/my-events/event/9/invite?token=d86c23aa687b19bb7e7f281d66d31f77\",\n \"signupFields\": [\n {\n \"id\": 64,\n \"isRequired\": true,\n \"options\": [\n \"1A\",\n \"2A\",\n \"1B\",\n \"2B\"\n ],\n \"order\": 0,\n \"question\": \"Division\",\n \"description\": \"\",\n \"type\": \"singleSelect\",\n \"key\": null\n }\n ]\n },\n {\n \"id\": 4,\n \"isLocked\": false,\n \"organisationId\": 1,\n \"title\": \"Test Event - Sound Recordings\",\n \"territory\": \"US\",\n \"endDate\": \"2024-04-04T00:00:00.000Z\",\n \"startDate\": \"2024-03-31T00:00:00.000Z\",\n \"inviteURL\": \"{{lvsURL}}/my-events/event/4/invite?token=ed10939224686762234d4bc992af552f\",\n \"signupFields\": [\n {\n \"id\": 37,\n \"isRequired\": true,\n \"options\": [],\n \"order\": 2,\n \"question\": \"Question 1\",\n \"description\": \"\",\n \"type\": \"shortAnswer\",\n \"key\": null\n },\n {\n \"id\": 42,\n \"isRequired\": true,\n \"options\": [],\n \"order\": 1,\n \"question\": \"Question 2\",\n \"description\": \"\",\n \"type\": \"shortAnswer\",\n \"key\": null\n },\n {\n \"id\": 62,\n \"isRequired\": true,\n \"options\": [\n \"division one\",\n \"division two\"\n ],\n \"order\": 0,\n \"question\": \"Division\",\n \"description\": \"\",\n \"type\": \"singleSelect\",\n \"key\": null\n }\n ]\n },\n {\n \"id\": 5,\n \"isLocked\": false,\n \"organisationId\": 1,\n \"title\": \"Test Event - Marching\",\n \"territory\": \"US\",\n \"endDate\": \"2023-08-31T00:00:00.000Z\",\n \"startDate\": \"2023-08-31T00:00:00.000Z\",\n \"inviteURL\": \"{{lvsURL}}/my-events/event/5/invite?token=80a0f0c69ef855f4304ece96e6af6dec\",\n \"signupFields\": [\n {\n \"id\": 36,\n \"isRequired\": true,\n \"options\": [],\n \"order\": 0,\n \"question\": \"123\",\n \"description\": \"\",\n \"type\": \"shortAnswer\",\n \"key\": null\n }\n ]\n }\n]" } ] } ] } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{accessToken}}", "type": "string" } ] }, "event": [ { "listen": "prerequest", "script": { "type": "text/javascript", "exec": [ "" ] } }, { "listen": "test", "script": { "type": "text/javascript", "exec": [ "" ] } } ] }